home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 009a / dtest12.zip / DTESTFOX.DOC < prev    next >
Text File  |  1991-06-11  |  2KB  |  55 lines
  1.          DTESTFOX 1.2 - A DISKETTE TEST MODULE FOR A FOXPRO PROGRAM
  2.          ==========================================================
  3.  
  4.   Written by:  Richard L. Fink
  5.                RainTree Computer Systems
  6.                P.O.Box 2339
  7.                Mill Valley, CA 94941
  8.  
  9.   Date:        June 11, 1991
  10.   Compiler:    MASM 6.0
  11.  
  12.   License:     DTESTFOX.BIN and it's assembler source file are hereby
  13.                placed in the Public Domain.
  14.  
  15.  
  16.   DTESTFOX.BIN is run as a Foxpro function.  It tests a diskette
  17.   drive to see whether or not it contains a diskette.  If a diskette is
  18.   detected, DTESTFOX will determine which of the following states it is in:
  19.   unformatted, formatted and empty, or formatted with files or directories.
  20.   A single ASCII number is returned for each condition.
  21.  
  22.   This is invaluable for preventing the dreaded:
  23.                     ABORT, RETRY, IGNORE?
  24.   in the middle of your beautiful Foxpro application screen.
  25.  
  26.   DTESTFOX.BIN is run by calling it as a Foxpro function, using the "With"
  27.   option.  The "With" value defines a one character field which contains
  28.   the letter of the diskette drive you wish to check.  Note that no
  29.   validation is performed on the drive character.
  30.  
  31.  
  32.   Summary:
  33.   --------
  34.  
  35.   Call Values:
  36.       This module expects a 1 character field passed to it.  That field
  37.       will contain the drive character in either upper or lower case.  On
  38.       entry to this module the field is pointed to by the registers DS:BX.
  39.  
  40.   Return Values:
  41.       This module will return a 1 character value to the calling program.
  42.       It will place that value in the source field, replacing the drive
  43.       character.
  44.  
  45.       The return value will be-
  46.            0 - Drive contains a formatted diskette which is empty.
  47.            1 - Drive contains a formatted diskette with files or directories.
  48.            2 - Drive contains an UNFORMATTED diskette.
  49.            3 - Drive does NOT contain a diskette.
  50.            4 - Drive is an unknown unit.
  51.  
  52.   -------------------------------------------------------------------------
  53.   The idea for DTESTFOX came from a DOS Tip by Dan Gookin in the April 1991
  54.   issue of PC Computing Magazine.
  55.